<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>PHP 8.1.x 废弃的功能</title>
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-base.css" />
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-medium.css" />

 </head>
 <body class="docs"><div class="navbar navbar-fixed-top">
  <div class="navbar-inner clearfix">
    <ul class="nav" style="width: 100%">
      <li style="float: left;"><a href="migration81.incompatible.html">« 不向后兼容的变更</a></li>
      <li style="float: right;"><a href="migration81.other-changes.html">其他变更 »</a></li>
    </ul>
  </div>
</div>
<div id="breadcrumbs" class="clearfix">
  <ul class="breadcrumbs-container">
    <li><a href="index.html">PHP Manual</a></li>
    <li><a href="migration81.html">从 PHP 8.0.x 移植到 PHP 8.1.x</a></li>
    <li>PHP 8.1.x 废弃的功能</li>
  </ul>
</div>
<div id="layout">
  <div id="layout-content"><div id="migration81.deprecated" class="sect1">
 <h2 class="title">PHP 8.1.x 废弃的功能</h2>

 <div class="sect2" id="migration81.deprecated.core">
  <h3 class="title">PHP 核心中废弃的功能</h3>

  <div class="sect3" id="migration81.deprecated.core.serialize-interface">
   <h4 class="title">
    实现无 <span class="function"><strong>__serialize()</strong></span> 和 <span class="function"><strong>__unserialize()</strong></span>
    的 <span class="interfacename"><a href="class.serializable.html" class="interfacename">Serializable</a></span>
   </h4>

   <p class="para">
    如果不用兼容 PHP 7.4 以前的版本，就只需要实现新的方法，否则需要同时实现两个方法。
   </p>
  </div>

  <div class="sect3" id="migration81.deprecated.core.null-not-nullable-internal">
   <h4 class="title">将 <strong><code>null</code></strong> 传递给内置函数的非 null 值参数</h4>

   <p class="para">
    为了与用户定义的函数行为保持一致，标量类型需要被明确标记为允许为 null，内置函数的标量类型默认情况下允许为 null 的行为已被废弃。

    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br />var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">str_contains</span><span style="color: #007700">(</span><span style="color: #DD0000">"foobar"</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">null</span><span style="color: #007700">));<br /></span><span style="color: #FF8000">//&nbsp;Deprecated:&nbsp;Passing&nbsp;null&nbsp;to&nbsp;parameter&nbsp;#2&nbsp;($needle)&nbsp;of&nbsp;type&nbsp;string<br />//&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;is&nbsp;deprecated<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
     </div>

    </div>
   </p>
  </div>

  <div class="sect3" id="migration81.deprecated.core.implicit-float-conversion">
   <h4 class="title">不兼容从 <span class="type">float</span> 到 <span class="type">int</span> 的隐式转换</h4>

   <p class="para">
    从 <span class="type">float</span> 隐式转换为 <span class="type">int</span> 将会导致精度的丢失，目前这种行为已被废弃。
    这将影响到 <span class="type">array</span> 中的键、严格模式下 <span class="type">int</span> 类型的声明以及对 <span class="type">int</span> 的操作。

    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br />$a&nbsp;</span><span style="color: #007700">=&nbsp;[];<br /></span><span style="color: #0000BB">$a</span><span style="color: #007700">[</span><span style="color: #0000BB">15.5</span><span style="color: #007700">];&nbsp;</span><span style="color: #FF8000">//&nbsp;废弃，作为键值将会丢失&nbsp;0.5<br /></span><span style="color: #0000BB">$a</span><span style="color: #007700">[</span><span style="color: #0000BB">15.0</span><span style="color: #007700">];&nbsp;</span><span style="color: #FF8000">//&nbsp;OK，因为&nbsp;15.0&nbsp;==&nbsp;15<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
     </div>

    </div>
   </p>
  </div>

  <div class="sect3" id="migration81.deprecated.core.static-trait">
   <h4 class="title">在 trait 上调用 <span class="modifier">static</span> 元素</h4>

   <p class="para">
    在 trait 上直接调用 <span class="modifier">static</span> 方法、直接访问
    <span class="modifier">static</span>
    属性的行为已被废弃。静态方法和属性只能在使用了 trait 的类上被访问。
   </p>
  </div>

  <div class="sect3" id="migration81.deprecated.core.magic-sleep">
   <h4 class="title">在 <span class="function"><strong>__sleep()</strong></span> 中返回非 <span class="type">array</span> 类型值</h4>

   <p class="para">
    在 <a href="language.oop5.magic.html#object.sleep" class="link">__sleep()</a> 中返回一个非 <span class="type">array</span> 类型的值现在将会产生一个诊断。
   </p>
  </div>

  <div class="sect3" id="migration81.deprecated.core.void-by-ref">
   <h4 class="title">在返回值为 void 的函数中通过引用进行返回</h4>

   <p class="para">
    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">function&nbsp;&amp;</span><span style="color: #0000BB">test</span><span style="color: #007700">():&nbsp;</span><span style="color: #0000BB">void&nbsp;</span><span style="color: #007700">{}<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
     </div>

    </div>
    这种函数是相互矛盾的，在调用时已经发出了 <strong><code>E_NOTICE</code></strong>
    提示：<code class="literal">Only variable references should be returned by reference</code>。
   </p>
  </div>

  <div class="sect3" id="migration81.deprecated.core.autovivification-false">
   <h4 class="title">对 <strong><code>false</code></strong> 进行自动代入（Autovivification）</h4>

   <p class="para">
    自动代入指的是追加一个值时创建出新 <span class="type">array</span> 的过程。对于标量值而言，自动代入是不被允许的；然而 false 是一个例外。现在这将会被废弃。

    <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br />$arr&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">false</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$arr</span><span style="color: #007700">[]&nbsp;=&nbsp;</span><span style="color: #0000BB">2</span><span style="color: #007700">;&nbsp;&nbsp;&nbsp;</span><span style="color: #FF8000">//&nbsp;废弃<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
     </div>

    </div>
   </p>
   <blockquote class="note"><p><strong class="note">注意</strong>: 
    <p class="para">
     对 <strong><code>null</code></strong> 或者未定义的值进行自动代入仍然是被允许的：
     <div class="informalexample">
      <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br /></span><span style="color: #FF8000">//&nbsp;从未定义的值<br /></span><span style="color: #0000BB">$arr</span><span style="color: #007700">[]&nbsp;=&nbsp;</span><span style="color: #DD0000">'some&nbsp;value'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$arr</span><span style="color: #007700">[</span><span style="color: #DD0000">'doesNotExist'</span><span style="color: #007700">][]&nbsp;=&nbsp;</span><span style="color: #0000BB">2</span><span style="color: #007700">;<br /></span><span style="color: #FF8000">//&nbsp;从&nbsp;null<br /></span><span style="color: #0000BB">$arr&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">null</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$arr</span><span style="color: #007700">[]&nbsp;=&nbsp;</span><span style="color: #0000BB">2</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
      </div>

     </div>
    </p>
   </p></blockquote>
  </div>

 </div>

 <div class="sect2" id="migration81.deprecated.ctype">
  <h3 class="title">ctype</h3>

  <div class="sect3" id="migration81.deprecated.ctype.nonstring-arguments">
   <h4 class="title">校验非字符串类型的参数</h4>

   <p class="para">
    传递一个非字符串类型参数的行为已被废弃。在将来，参数将被解释为一个字符串而不是 ASCII 编码。根据可预期的行为，参数需要被转化为 <span class="type">string</span> 或者对
    <span class="function"><a href="function.chr.html" class="function">chr()</a></span> 进行一次显式调用。这会影响所有的 <code class="literal">ctype_*()</code>
    函数。
   </p>
  </div>
 </div>

 <div class="sect2" id="migration81.deprecated.date">
  <h3 class="title">Date</h3>

  <p class="para">
   在 <span class="function"><a href="function.date-sun-info.html" class="function">date_sun_info()</a></span> 的支持下，<span class="function"><a href="function.date-sunrise.html" class="function">date_sunrise()</a></span>
   和 <span class="function"><a href="function.date-sunset.html" class="function">date_sunset()</a></span> 已被废弃。
  </p>

  <p class="para">
   <span class="function"><a href="function.strptime.html" class="function">strptime()</a></span> 已被废弃。请使用
   <span class="function"><a href="function.date-parse-from-format.html" class="function">date_parse_from_format()</a></span>
   （不依赖 locale 的解析）或者 <span class="methodname"><a href="intldateformatter.parse.html" class="methodname">IntlDateFormatter::parse()</a></span>
   （依赖 locale 的解析）代替。
  </p>

  <p class="para">
   <span class="function"><a href="function.strftime.html" class="function">strftime()</a></span> 和 <span class="function"><a href="function.gmstrftime.html" class="function">gmstrftime()</a></span>
   已被废弃。请使用<span class="function"><a href="function.date.html" class="function">date()</a></span>（不依赖 locale 的格式化）或者
   <span class="methodname"><a href="intldateformatter.format.html" class="methodname">IntlDateFormatter::format()</a></span>
   （依赖 locale 的格式化）代替。
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.filter">
  <h3 class="title">Filter</h3>

  <p class="para">
   <strong><code>FILTER_SANITIZE_STRING</code></strong> 和
   <strong><code>FILTER_SANITIZE_STRIPPED</code></strong> 过滤器已被废弃。
  </p>
  <p class="para">
   INI 设置项 <a href="filter.configuration.html#ini.filter.default" class="link">filter.default</a>
   已被废弃
   
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.gd">
  <h3 class="title">GD</h3>

  <p class="para">
   <span class="function"><a href="function.imagepolygon.html" class="function">imagepolygon()</a></span>、<span class="function"><a href="function.imageopenpolygon.html" class="function">imageopenpolygon()</a></span> 和
   <span class="function"><a href="function.imagefilledpolygon.html" class="function">imagefilledpolygon()</a></span>
   的 <code class="parameter">num_points</code> 参数已被废弃。
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.hash">
  <h3 class="title">Hash</h3>

  <p class="para">
   <span class="function"><a href="function.mhash.html" class="function">mhash()</a></span>、
   <span class="function"><a href="function.mhash-keygen-s2k.html" class="function">mhash_keygen_s2k()</a></span>、
   <span class="function"><a href="function.mhash-count.html" class="function">mhash_count()</a></span>、
   <span class="function"><a href="function.mhash-get-block-size.html" class="function">mhash_get_block_size()</a></span>、
   <span class="function"><a href="function.mhash-get-hash-name.html" class="function">mhash_get_hash_name()</a></span> 已被废弃。 请使用
   <code class="literal">hash_*()</code> 系列函数代替。
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.imap">
  <h3 class="title">IMAP</h3>

  <p class="para">
   <strong><code>NIL</code></strong> 常量已被废弃。请使用 <code class="literal">0</code> 代替。
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.intl">
  <h3 class="title">Intl</h3>

  <p class="para">
   使用 <span class="type">bool</span> 参数调用 <span class="methodname"><a href="intlcalendar.roll.html" class="methodname">IntlCalendar::roll()</a></span>
   已被废弃。请分别使用 <code class="literal">1</code> 和
   <code class="literal">-1</code> 来代替 <strong><code>true</code></strong> and <strong><code>false</code></strong>。
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.mbstring">
  <h3 class="title">多字节字符串</h3>

  <p class="para">
   无参数调用 <span class="function"><a href="function.mb-check-encoding.html" class="function">mb_check_encoding()</a></span> 已被废弃。
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.mysqli">
  <h3 class="title">MySQLi</h3>

  <p class="para">
   <span class="property">mysqli_driver::$driver_version</span> 属性已被废弃。它是无意义且过时的，使用
   <strong><code>PHP_VERSION_ID</code></strong> 来代替。
  </p>

  <p class="para">
   使用 <code class="parameter">mysqli</code> 参数来调用
   <span class="methodname"><a href="mysqli.get-client-info.html" class="methodname">mysqli::get_client_info()</a></span>
   或 <span class="function"><a href="mysqli.get-client-info.html" class="function">mysqli_get_client_info()</a></span> 已被废弃。请不带任何参数调用
   <span class="function"><a href="mysqli.get-client-info.html" class="function">mysqli_get_client_info()</a></span>
   来获取客户端类库的版本信息。
  </p>

  <p class="para">
   <span class="methodname"><a href="mysqli.init.html" class="methodname">mysqli::init()</a></span> 方法已被废弃。使用 <span class="methodname"><strong>parent::__construct()</strong></span>
   来代替对 <span class="methodname"><strong>parent::init()</strong></span> 的调用。
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.oci8">
  <h3 class="title">OCI8</h3>

  <p class="para">
   INI 设置项
   <a href="oci8.configuration.html#ini.oci8.old-oci-close-semantics" class="link">oci8.old_oci_close_semantics</a>
   已被废弃。
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.odbc">
  <h3 class="title">ODBC</h3>

  <p class="para">
   <span class="function"><a href="function.odbc-result-all.html" class="function">odbc_result_all()</a></span> 已被废弃。
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.pdo">
  <h3 class="title">PDO</h3>

  <p class="para">
   <strong><code>PDO::FETCH_SERIALIZE</code></strong> 获取模式已被废弃。
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.pgsql">
  <h3 class="title">PgSQL</h3>

  <p class="para">
   对于所有 <code class="literal">pgsql_*()</code> 函数不传递连接参数的方式已被废弃。
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.soap">
  <h3 class="title">SOAP</h3>

  <p class="para">
   在 SSL 流上下文参数的代替下，
   <span class="methodname"><a href="soapclient.construct.html" class="methodname">SoapClient::__construct()</a></span> 的
   <code class="literal">ssl_method</code> 选项已被废弃。
   
  </p>
 </div>

 <div class="sect2" id="migration81.deprecated.standard">
  <h3 class="title">常规</h3>

  <p class="para">
   对一个对象调用 <span class="function"><a href="function.key.html" class="function">key()</a></span>、<span class="function"><a href="function.current.html" class="function">current()</a></span>、
   <span class="function"><a href="function.next.html" class="function">next()</a></span>、<span class="function"><a href="function.prev.html" class="function">prev()</a></span>、
   <span class="function"><a href="function.reset.html" class="function">reset()</a></span>、<span class="function"><a href="function.end.html" class="function">end()</a></span>
   已被废弃。对一个对象应优先使用 <span class="function"><a href="function.get-mangled-object-vars.html" class="function">get_mangled_object_vars()</a></span>，或使用
   <span class="classname"><a href="class.arrayiterator.html" class="classname">ArrayIterator</a></span>。
  </p>

  <p class="para">
   INI 配置项
   <a href="filesystem.configuration.html#ini.auto-detect-line-endings" class="link">auto_detect_line_endings</a>
   已被废弃。如有必要，可以手动处理 <code class="literal">&quot;\r&quot;</code> 换行符。
  </p>

  <p class="para">
   <strong><code>FILE_BINARY</code></strong> 和 <strong><code>FILE_TEXT</code></strong>
   常量已被废弃。它们从未产生过任何作用。
  </p>
 </div>

</div></div></div></body></html>